home *** CD-ROM | disk | FTP | other *** search
/ SGI Hot Mix 17 / Hot Mix 17.iso / HM17_SGI / research / rel_note.txt < prev   
Encoding:
Text File  |  1997-07-08  |  10.9 KB  |  270 lines
  1. ---------------------------------------------------------------------
  2. Release Notes: CD-ROM      and    CD-ROM
  3.         info               root directory
  4.          rel_note.txt       rel_note.txt
  5.  
  6. IDL Version 5.0
  7. ---------------------------------------------------------------------
  8.  
  9. This document discusses known anomalies in IDL version 5.0.
  10.  
  11. NOTE: Please read any platform-specific notes files contained in
  12.       the "info" directory before installing IDL.
  13.  
  14.  
  15. Note to IDL BETA and Pre-Release Users
  16. --------------------------------------
  17.   Remove your Beta or Pre-Release installation of IDL
  18.     We recommend that you completely remove your IDL 5.0
  19.     beta or Pre-Release installation before installing
  20.     the final release version of IDL 5.0. If you are
  21.     using Microsoft Windows, be sure to remove the old
  22.     IDL program group as well. (If you use Windows 95
  23.     or Windows NT version 4.0, use "Add/Remove Programs"
  24.     in the control panel.)
  25.  
  26.     While IDL will function properly if you do not remove
  27.     the beta or Pre-Release installation, several files
  28.     have been moved or renamed. Starting fresh will reduce
  29.     the chances for confusion.
  30.  
  31.     If you are running Microsoft Windows, and you have created
  32.     new macros in the IDL Development Environment or otherwise
  33.     modified your macros.ini file, save the file before removing
  34.     the old version of IDL (or before installing the new version
  35.     if you do not remove the old version -- the old file will be
  36.     overwritten by the installation program). You can merge your
  37.     file with the new macros.ini file after installation.
  38.   
  39.  
  40.   Delete or Rename .idlde Resource Files (Unix and VMS)
  41.     The final release version of IDL installs a new .idlde
  42.     file that contains additional macros. Delete the existing
  43.     .idlde file from your home directory before running the
  44.     final release version of IDL. If you have customized this
  45.     file (either manually or via the Macros menu), you can
  46.     rename the file and merge your changes into the new version
  47.     that is created when you run IDL.
  48.  
  49.   Delete Insight Template and Preference Files:
  50.     If you have been using the IDL version 5.0 Pre-Release
  51.     on a Unix or VMS system, and have been using Insight,
  52.     you must remove the following files:
  53.  
  54.     Unix:
  55.     ~/.insight.ipj
  56.     ~/.insight.prf
  57.  
  58.     VMS:
  59.     [SYS$LOGIN]INSIGHT.IPJ
  60.     [SYS$LOGIN]INSIGHT.PRF
  61.     
  62.     On Windows and Macintosh systems, before installing the new IDL
  63.     distribution, either rename or delete the old distribution so 
  64.     that the template and preferences files will be installed correctly.
  65.  
  66.   Delete Insight Project Files:    
  67.     If you have created any project files (*.ipj files) of your own, 
  68.     you will not be able to use them with the final release version 
  69.     of Insight. Please delete them before installing IDL.
  70.  
  71.  
  72. IDL Development Environment
  73. ---------------------------
  74.   Recall Buffer Size (Windows Only)
  75.     You cannot change the size of the IDL for Windows command
  76.     line recall buffer via the "General" tab of the Preferences
  77.     dialog. 
  78.  
  79.     You can change the number of command lines saved in the recall
  80.     buffer by setting the value of the !EDIT_INPUT system variable
  81.     equal to the number of lines you would like to save. In order
  82.     for the change to take effect, IDL must be able to process the
  83.     assignment statement before providing a command prompt. This
  84.     means that you must put the assignment statement in the IDL
  85.     startup file. (See "Startup File" in chapter 2 of _Using IDL_
  86.     for more information on startup files.)
  87.  
  88.   Hiding the Toolbar (SGI Irix 5.3 Only)
  89.     Under Silicon Graphics Irix version 5.3, a problem in the SGI
  90.     XtIntrinsics library causes IDL to abort if the IDLDE toolbar
  91.     is hidden. This problem does not occur under Irix versions
  92.     6.2 and above.
  93.  
  94.  
  95. Insight
  96. -------
  97.   IEEE NAN:
  98.     Insight may not behave as expected when working with data involving
  99.     IEEE NAN (Not A Number) values.
  100.  
  101.   Saving Projects in Insight:
  102.     If you attempt to exit Insight without saving a new or changed 
  103.     project, Insight will ask if you wish to save the project. If you
  104.     attempt to exit IDL without saving changes you made during an 
  105.     Insight session, IDL will exit without saving your changes. Always
  106.     exit Insight before exiting IDL.
  107.  
  108.   Writing Insight PlugIns:
  109.     Do not call any routines (procedures or functions) from within
  110.     a PlugIn registration function.
  111.  
  112.   Page Setup:
  113.     The "Page Setup" option of the File menu only available on
  114.     Macintosh platforms.
  115.  
  116.  
  117. Fonts in Object Graphics
  118. ------------------------
  119.   Windows Only:
  120.     When a large number of fonts are installed on the system, object
  121.     graphics code that utilize IDLgrText objects will fail with a
  122.     not enough memory error.
  123.  
  124.   Unix Only:
  125.     If you run IDL directly from the CD-ROM (that is, without installing
  126.     it on your system), and there is a "." in the path name you use
  127.     to call the IDL executable, you will see font server errors from
  128.     the Gallium Font Server. You can safely ignore these messages.
  129.  
  130.   VMS Only:
  131.     The Gallium FontServer used by IDL for TrueType font support for
  132.     projected text in Object Graphics is not supported on VMS platforms.  
  133.     On VMS, the IDLgrFont name property may still be set to 'Helvetica', 
  134.     'Times', 'Courier', or 'Symbol'; a Hershey text equivalent will be 
  135.     used for these cases. Note that for on-glass text, Helvetica, 
  136.     Times, Courier, and/or Symbol fonts may be available if they are 
  137.     among the X fonts available on your system.
  138.  
  139.  
  140.  
  141. OpenGL and Object Graphics
  142. --------------------------  
  143.   Setting RETAIN:
  144.     Setting RETAIN=2 for Object Graphics may not be supported on 
  145.     some hardware configurations using native OpenGL.  In this case, 
  146.     a warning message will be printed to the screen indicating that
  147.     the RETAIN value will be reset to 1 (system-buffered mode).
  148.  
  149.   Sun Ultra Only:
  150.     For the Ultra Creator 3D Graphics family of graphics accelerators,
  151.     Sun's native implementation of OpenGL may not be included in the
  152.     software that is bundled with the machine upon purchase; you may
  153.     have to purchase OpenGL separately. Note that the performance of
  154.     Object Graphics in IDL will noticeably improve if Sun's native OpenGL
  155.     is installed.
  156.  
  157.     You can check if Sun's OpenGL is installed by determining if the
  158.     file called libGL.so exists in the directory /usr/openwin/lib.
  159.  
  160.     The hardware OpenGL on the Sun Ultra has some bugs that become
  161.     apparent when certain features of IDL's object graphics are used.
  162.     These include:
  163.     - Depth-cuing to non-black background fails (appears as if the
  164.       colors are not clamped properly).
  165.     - Images with an odd number of rows or columns can hang the 
  166.       graphics pipe.
  167.     - Images may be clipped.
  168.     - Flat shaded polygons will sometimes be displayed in the wrong
  169.       colors (due to a two-sided lighting bug).
  170.     - Polylines (including axis lines, etc.) that fall outside the
  171.       edges of a view (and are therefore clipped) may be drawn
  172.       improperly if the THICK property of the line is not equal
  173.       to 1.
  174.  
  175.   SGI Irix and Windows Only:
  176.     The hardware OpenGL on Irix and on Windows 95 and Windows NT has
  177.     a bug that causes luminance-alpha texture maps not to display properly.
  178.  
  179.  
  180. Color Issues
  181. ------------
  182.   Direct Color for the X Device:
  183.     The colormap handling for the DirectColor Visual in IDL has been
  184.     rewritten to allocate color planes.  This allows shared colormaps
  185.     to be used with DirectColor. Due to planar restrictions, fewer 
  186.     color cells may be available to DirectColor than normally 
  187.     available in the shared colormap.
  188.  
  189.     For the DirectColor or TrueColor visual, the TRANSLATION keyword 
  190.     to the DEVICE routine will now return a 768 element array.  This 
  191.     array is the translation of the red channel (the first 256 
  192.     elements) followed by the green and finally the blue.  The array 
  193.     values are longs.  To translate the color pixel triplet (10,20,30), 
  194.     connect the values of t[10], t[20+256], and t[30+512] with OR 
  195.     (where t is the translation table) to arrive at a color pixel value.  
  196.  
  197.   Problems with Motif window managers:
  198.     Some Motif window managers (notably mwm and CDE) do not always
  199.     properly install colormaps when switching from RGB to Indexed
  200.     Color mode. You may notice colormap problems if you create
  201.     IDL Object Graphics windows using RGB mode (the default), then
  202.     create windows using indexed color mode. This is a limitation
  203.     of the window manager; the only workaround currently available
  204.     is to close the IDL session and restart, then open the indexed
  205.     color mode window.
  206.  
  207.   Windows 3.11 and Indexed Color:
  208.     Under Windows 3.11, colormaps are not handled properly in
  209.     Object Graphics display objects (IDLgrWindow and IDLgrPrinter
  210.     objects). As a result, window and printer objects created in
  211.     Indexed color mode do not function properly. A solution
  212.     for this problem is in development and will be made available
  213.     after the IDL version 5.0 release.
  214.  
  215.  
  216. 16-bit Pixel Depths (Unix Only)
  217. -------------------------------
  218.     IDL Direct Graphics do not support the use of 16-bit
  219.     "true color" video displays on systems running Motif window
  220.     managers.
  221.     
  222.     It _is_ possible to create indexed color windows on Unix
  223.     machines with 16-bit video using IDL Object Graphics. Note,
  224.     however, that routines that rely on IDL Direct Graphics
  225.     (notably the hourglass cursor created with the command
  226.     WIDGET_CONTROL, /HOURGLASS) will not function properly in
  227.     this situation.
  228.  
  229.  
  230. IDL DataMiner
  231. -------------
  232.   Solaris and SunOS Only:
  233.     The database connection dialog, DIALOG_DBCONNECT(), returns 0
  234.     and the dialog does not appear. To work around this problem,
  235.     you can use the CONNECT() method on the IDLdbDATABASE object.
  236.  
  237.   Windows NT version 4.0 Only:
  238.     If you have installed Service Pack 2 on your Windows NT version
  239.     4.0 system, IDL and the IDL DataMiner may behave sporadically. 
  240.     Research Systems recommends that you _not_ install Service Pack 2.
  241.  
  242.  
  243. IDL Memory Partition (Macintosh Only)
  244. -------------------------------------
  245.     In many cases, increasing the memory partition allocated to
  246.     IDL will improve the performance of IDL. If you have memory
  247.     available, increasing IDL's allotment will increase the
  248.     speed of computation- or graphics-intensive operations and
  249.     applications.
  250.  
  251.  
  252. On-line Help (Windows Only)
  253. ---------------------------
  254.     If you select "Contents" from the IDLDE Help menu, and then select
  255.     a volume other than (1) Using IDL, (2) Building IDL Applications, or
  256.     (3) IDL Reference Guide first, you may encounter a "file not found"
  257.     error. There are two solutions:
  258.  
  259.       - Open one of the above files, or the "IDL Online Help Navigator"
  260.     page, before opening another help file.
  261.  
  262.       - When you get the "file not found" error, click "Yes" to find the
  263.     file, open the "help" directory of the IDL distribution, and
  264.     double-click on the help file you want.
  265.  
  266.      Windows will remember the location of the help file after the first
  267.      time you have opened it.
  268.  
  269.  
  270.